IMBannerDelegate Protocol Reference
| Conforms to | NSObject |
| Declared in | IMBannerDelegate.h |
Overview
- A listener for receiving notifications during the lifecycle of a banner ad. *
- Note All the events in this listener will be invoked on your application’s UI thread.
In most cases your application will need to listen for the following events on a banner ad
The outcome of an ad request (if the request succeeded or failed); see bannerDidFinishLoading:(IMBanner)banner; and banner:(IMBanner)banner didFailToLoadWithError:(IMRequestStatus*)error;
The ad opened an overlay that covered the screen. This means that the user can no longer interact with your application; see bannerDidPresentScreen:(IMBanner*)banner
The ad overlay opened was dismissed. The user is now free to interact with your application; see bannerDidDismissScreen:(IMBanner*)banner;
A user interaction with the ad will result in the User leaving your application context; see userWillLeaveApplicationFromBanner:(IMBanner*)banner;
If your application involves running rewarded or incentivised ads, then you should, in addition to the above events, also listen for the banner:(IMBanner)banner rewardActionCompletedWithRewards:(NSDictionary)rewards event and handle it appropriately to unlock rewards for the user of your app.
Tasks
-
– bannerDidFinishLoading:required method -
– banner:didFailToLoadWithError:required method -
– banner:didInteractWithParams:required method -
– userWillLeaveApplicationFromBanner:required method -
– bannerWillPresentScreen:required method -
– bannerDidPresentScreen:required method -
– bannerWillDismissScreen:required method -
– bannerDidDismissScreen:required method -
– banner:rewardActionCompletedWithRewards:required method
Instance Methods
banner:didFailToLoadWithError:
Notifies the delegate that the banner has failed to load with some error.
- (void)banner:(IMBanner *)banner didFailToLoadWithError:(IMRequestStatus *)errorDiscussion
Notifies the delegate that the banner has failed to load with some error.
Declared In
IMBannerDelegate.hbanner:didInteractWithParams:
Notifies the delegate that the banner was interacted with.
- (void)banner:(IMBanner *)banner didInteractWithParams:(NSDictionary *)paramsDiscussion
Notifies the delegate that the banner was interacted with.
Declared In
IMBannerDelegate.hbanner:rewardActionCompletedWithRewards:
Notifies the delegate that the user has completed the action to be incentivised with.
- (void)banner:(IMBanner *)banner rewardActionCompletedWithRewards:(NSDictionary *)rewardsDiscussion
Notifies the delegate that the user has completed the action to be incentivised with.
Declared In
IMBannerDelegate.hbannerDidDismissScreen:
Notifies the delegate that the banner has dismissed the presented screen.
- (void)bannerDidDismissScreen:(IMBanner *)bannerDiscussion
Notifies the delegate that the banner has dismissed the presented screen.
Declared In
IMBannerDelegate.hbannerDidFinishLoading:
Notifies the delegate that the banner has finished loading
- (void)bannerDidFinishLoading:(IMBanner *)bannerDiscussion
Notifies the delegate that the banner has finished loading
Declared In
IMBannerDelegate.hbannerDidPresentScreen:
Notifies the delegate that the banner has finished presenting screen.
- (void)bannerDidPresentScreen:(IMBanner *)bannerDiscussion
Notifies the delegate that the banner has finished presenting screen.
Declared In
IMBannerDelegate.hbannerWillDismissScreen:
Notifies the delegate that the banner will start dismissing the presented screen.
- (void)bannerWillDismissScreen:(IMBanner *)bannerDiscussion
Notifies the delegate that the banner will start dismissing the presented screen.
Declared In
IMBannerDelegate.hbannerWillPresentScreen:
Notifies the delegate that the banner would be presenting a full screen content.
- (void)bannerWillPresentScreen:(IMBanner *)bannerDiscussion
Notifies the delegate that the banner would be presenting a full screen content.
Declared In
IMBannerDelegate.huserWillLeaveApplicationFromBanner:
Notifies the delegate that the user would be taken out of the application context.
- (void)userWillLeaveApplicationFromBanner:(IMBanner *)bannerDiscussion
Notifies the delegate that the user would be taken out of the application context.
Declared In
IMBannerDelegate.h